Continuous object sychronization between object stores on different computers

ABSTRACT

Disclosed herein is a system for synchronizing object instances between first and second object stores. The system includes a primary computer and a portable computer that is connectable with the primary computer for data communications. A first object store manager executes on the portable computer to maintain the first object store, and a second object store manager executes on the primary computer to maintain the second object store. In addition, a synchronization manager executes on the primary computer. The synchronization manager compares object instances from the first and second object stores in response to initially connecting the portable computer for data communications with the primary computer, and synchronizes any objects whose instances differ from each other. After the initial synchronization, the first object store manager initiates a notification to the synchronization manager whenever an instance of a particular object in the first object store changes. In response, the synchronization manager synchronizes the instances of the identified object in the first and second object stores.

RELATED APPLICATIONS

This application is a continuation-in-part of Ser. No. 08/944,948, entitled "Object Synchronization Between Object Stores on Different Computers", filed Oct. 2, 1997, pending.

TECHNICAL FIELD

This invention relates to methods of synchronizing any form of data such as databases used in personal information managers, especially when the databases are used on two different computers that are only occasionally connected for data communications.

BACKGROUND OF THE INVENTION

As electronic components have continued to become smaller and less expensive, laptop, handheld, and other portable computers have become more and more popular. Although a variety of applications can be used with such computers, personal information managers (PIMs) form an important category of application programs that are particularly suited for use with portable computers or other portable information devices.

To get the most benefit from a PIM on a portable device, it is very useful if the PIM information can be kept up to date with a PIM that a user uses in conjunction with his or her desktop computer. Many portable computers are designed to connect with a desktop and to exchange information. When compatible PIMs are used on a portable computer and a desktop computer, it is possible to use this connectivity to update the PIMs so that the latest updates made by a user on one PIM are also reflected in the other PIM. This is referred to as "synchronization."

There are many competing desktop PIM applications on the market today. Each of them uses very different data formats. It is imperatively important for a portable device to be able to synchronize its data with each of these PIM applications. This requires a flexible and extensible architecture such that a synchronization software module can be easily written for a particular PIM application.

Previous methods of synchronization have not provided such an architecture. Rather, previous methods have been limited to synchronization between a portable PIM and a single, usually proprietary, desktop PIM.

In contrast to previous methods of synchronizing PIMs, the inventors have developed a versatile system that allows a PIM on a portable computer to be synchronized with a great variety of desktop PIMs. An important advantage of the invention is that neither PIM component is required to track changes. Rather, this is taken care of by software components that are independent of the PIMs. These independent components can be used in conjunction with a number of different PIMs or similar database programs. Another important advantage of the invention is that it makes no assumption on the format of the data that are transferred between two computers. Therefore, the developer of a synchronization module has the total freedom to use different data formats depending only on specifics of the particular PIM application. A further advantage of the invention is that synchronization takes place automatically, without user intervention. Because of this, a user can have a high degree of confidence that all data is up-to-date whenever disconnecting the portable computer from its associated desktop computer.

SUMMARY OF THE INVENTION

In accordance with the invention, a synchronization manager executes on a primary computer. The synchronization manager maintains a reference store and communicates with an auxiliary computer. Respective PIMs or other database management programs run on each computer. An object store is maintained on each computer.

Two additional components (usually in the form of DLLs) are used. A first interface component is associated with the PIM that executes on the primary computer. A second interface component is associated with the PIM that executes on the auxiliary computer. Each component exposes a defined set of interface methods.

On the primary computer, identifying data segments are maintained persistently in the reference store for each object in the primary computer's object store. The data segments are defined by the developer of the interface components--the synchronization manager has no knowledge of the type of data stored in these segments. The identifying data segments are derived from the objects, so that comparing a stored identifying data segment with a currently derived data segment results in an indication of whether the corresponding object has been changed since it was last synchronized. Such comparisons are performed by the interface components, rather than by the synchronization manager.

In the exemplary implementation of the invention, the identifying data segments include data representing any properties provided by the auxiliary computer's object store that are not supported in the primary computer's object store. This allows such properties to be recovered from the primary computer if they are lost from the auxiliary object store.

Objects stored in the object store maintained by the auxiliary computer also have identifiers. These identifiers are usually different from the identifying data segments used in the primary object store. A mapping is maintained by the synchronization manager so that when an object is changed in one store, the corresponding object in another store can be located and the same change can be applied to that object. Each time a new object in the primary store is created and synchronized to the auxiliary store, the synchronization manager retrieves the identifier for that new object in the auxiliary object store and uses it to establish a mapping between these two objects. All these mappings are stored in synchronization manager's reference store, along with the identifying data segments.

Whenever an object needs to be transferred from one store to another, the synchronization manager calls interface methods exposed by the interface components. These methods convert an object into a series of bytes. The synchronization manager then transfers these bytes to the other store and by calling an interface method that converts the bytes back to an object.

When the primary and auxiliary computers are initially connected, a full comparison is performed of all objects in the object stores of the computers. Thereafter, as long as the computers remain connected, the auxiliary computer sends immediate notifications to the desktop computer whenever changes are made to object instances in the object store of the auxiliary computer. In response, the synchronization manager synchronizes, without user intervention, whatever objects have been changed.

BRIEF DESCRIPTION OF THE DRAWINGS

FIG. 1 is a block diagram of a system in accordance with the invention for synchronizing two object stores.

FIG. 2 shows a primary desktop computer such as used in conjunction with the invention.

FIG. 3 is a simplified block diagram of the desktop computer of FIG. 2.

FIG. 4 shows an auxiliary, portable computer such as used in conjunction with the invention.

FIG. 5 is a simplified block diagram of the portable computer of FIG. 4.

FIG. 6 is an architectural diagram of a system in accordance with the invention for synchronizing object stores maintained on two different computers.

FIGS. 7-16 are flowcharts illustrating methodological steps performed in accordance with the invention.

DETAILED DESCRIPTION General Architecture

FIG. 1 shows a continuously synchronized storage system 10 for synchronizing objects between first and second object stores. The system comprises a primary computer 12 and a portable computer or information device 20. An application program 16 executes on the primary computer to maintain a first or primary object store 18 on the primary computer. The application program is a personal information manager (PIM) or contact database program in the exemplary embodiment of the invention, although other database programs and various applications might also be configured to take advantage of the synchronization architecture described herein.

The Schedule+ program, available from Microsoft Corporation of Redmond, Wash., is one example of a PIM that can be configured in accordance with the invention. Microsoft Outlook 97 is another example. The primary object store, also referred to as a desktop object store, is configured to store a plurality of individual records or objects, each comprising a plurality of fields or properties. In Schedule+, for example, there are objects of different types, corresponding to appointments, contacts, and tasks. Each object comprises a plurality of properties, such as addresses, phone numbers, task descriptions, etc.

Portable information device 20 is implemented as a handheld personal computer (H/PC). H/PC 20 executes an application program 22 that maintains a second or auxiliary object store 24, also referred to as the H/PC object store. The application program in the exemplary embodiment of the invention is a general-purpose PIM.

The auxiliary object store similarly stores a plurality of objects, each comprising a plurality of properties. The objects are intended to be synchronized with the objects in primary store 18. Conceptually, any particular object exists in both H/PC object store 24 and desktop object store 18. Actually, however, there are two synchronized instances of the same object. When a user modifies one instance of an object, the other instance needs to also be modified so that the instances eventually contain identical data. This is referred to as synchronization, and is preferably accomplished without significant user effort.

In some situations, the H/PC object store has objects that include properties not supported by the desktop object store. As an example, a "contact" object in the H/PC object store includes a "home fax number" property that is not supported by Schedule+. Special steps are taken in accordance with the invention to accommodate this situation.

Synchronization managers run on both computers, communicating with the application programs on both computers through well defined interfaces to manage communications and synchronization. The synchronization managers of the two computers communicate with each other via an available communications medium 26 such as a physical cable or connection using a serial communications protocol. IR (infrared) communications can alternatively be used. Such communications capabilities are commonly available in desktop and portable computers.

FIG. 2 shows primary computer 12 as a conventional desktop computer. Desktop computer 12 in the illustrated embodiment is a conventional IBM-compatible computer having a central processing unit (CPU) 30, a display monitor 32, a keyboard 34, and a mouse 36. The computer 12 also utilizes a computer-readable storage medium such as a floppy memory diskette 38 in conjunction with a floppy disk drive 40. Computer 12 utilizes a further computer-readable storage medium in the form of an optical storage medium 42, such as a CD-ROM or DVD, in conjunction with a CD-reader or access device 43. Computer 12 might also include another input device in addition to, or in lieu of, the keyboard 34 and mouse 36 including such devices as a track ball, stylus, or the like.

FIG. 3 shows a functional block diagram of computer 12. Computer 12 has a processor 46 and one or more forms of computer-readable storage media. Specifically, computer 12 includes a volatile memory 48 (e.g., RAM), and a non-volatile memory 50 interconnected by an internal bus 52. The non-volatile memory 50 can be implemented as integrated circuit chips (e.g., ROM, EEPROM), disk drive(s) (e.g., floppy, optical, hard), or a combination of both.

The display 32 is connected to the bus 52 through appropriate hardware interface drivers (not shown). Additionally, the input devices 34,36 are connected to supply data to the bus 52 via appropriate I/O ports. Floppy drive 40 and access device 43 are also connected through bus 52. Computer 12 includes a serial communications port 44 for communicating with portable information device 20. The serial communications port is connected for communications with processor 46 through bus 52.

The computer 12 runs an operating system 56 that is stored on the non-volatile memory 50 and executes on the processor 46. One preferred operating system is a Windows brand operating system sold by Microsoft Corporation, such as Windows 95 or Windows NT or other derivative versions of Windows. However, other operating systems may be employed, such as the Macintosh OS from Apple Corporation and the OS/2 Presentation Manager from IBM.

Application program 16 is stored in memory 48 or 50. An application such as Schedule+ can be loaded into memory 48 or 50 from the floppy diskette 38 or CD-ROM 42, or alternatively, downloaded from a network via a network port (not shown). A dynamically linked library (DLL) 17, comprising a plurality of executable functions, is associated with application program 16 for execution by processor 46.

Inter-process and inter-component calls are facilitated by using the component object model (COM) as is common in programs written for Microsoft Windows operating systems. When using COM, a software component such as the DLL mentioned above has a number of interfaces. Each interface exposes a plurality of methods, which can be called individually to utilize different services offered by the software component. In this document, the term "interface" is used somewhat more generically to indicate one or more software components, methods, or functions that can be called by some other software component, and that can optionally receive and return one or more parameter arguments. When first and second interfaces are described, for example, this could refer to two methods that are grouped together under the heading of a single COM interface.

Generally, the DLL associated with a particular application program is designed specifically to work in conjunction with that application program and to expose desktop synchronization interfaces that function as described below. Specifically, the DLL has a plurality of specifically defined interfaces that can be called by other programs or processes executing on computer 12. The DLL, in turn, is able to call interfaces exposed by application program 16, in order to access data representing individual properties of objects maintained by the application program. If the system includes a plurality of application programs that are to participate in synchronization, there is a DLL for each application program. Each DLL exposes the same set of interfaces. The applications themselves typically have widely different interfaces to which the DLLs must adapt.

FIG. 4 shows a portable information device or handheld personal computer (H/PC) 20 such as might be used in conjunction with the invention. For purposes of this description, the term "portable information device" means a small computing device having a processing unit that is capable of running one or more application programs, a display, and an input mechanism that is typically something other than a full-size keyboard. The input mechanism might be a keypad, a touch-sensitive screen, a track ball, a touch-sensitive pad, a miniaturized QWERTY keyboard, or the like. In other implementations, the portable information device may be implemented as a personal digital assistant (PDA), a personal organizer, a palmtop computer, a computerized notepad, or the like.

H/PC 20 has components similar to those of desktop computer 12, including a miniaturized keyboard 62 and a small LCD display 64. Instead of a mouse, H/PC 20 uses a touch-sensitive display screen in conjunction with a stylus 66. The stylus is used to press the display at designated coordinates for user input.

FIG. 5 shows pertinent functional components of H/PC 20. It has a processor 66, memory 68, and I/O components 70 (including the display and keyboard). These components communicate over a bus 72. A serial interface 74 is available for communications with desktop computer 12. In current H/PCs, memory 68 is non-volatile electronic memory such as battery-backed RAM (random access memory). Part of this memory is allocated as addressable memory for program execution, and the remaining part is used to simulate disk storage.

An operating system 76 is loaded in and executes on processor 66 from memory 68 of H/PC 20. H/PC 20 preferably runs the Windows CE operating system from Microsoft Corporation. This operating system is a derivative of Windows brand operating systems, such as Windows 95, that is especially designed for handheld computing devices. Windows CE implements database features that can be utilized by application programs through a set of exposed application programming interfaces and methods. These interfaces are described in the section entitled "Application Program Interfaces and Methods, Part A" below. Second object store 24 (FIG. 1) is maintained by the operating system, at least partially in response to calls to these interfaces from application programs such as PIMs.

Application program 22 executes from memory 68 of H/PC 20. The application program in one embodiment is a PIM that utilizes the database features of the Windows CE operating system to store objects and their properties. This application program is not necessarily designed to be compatible with the PIM that executes on the desktop computer. Specifically, there may not be a one-to-one matching between the properties of specific object types. Some properties in the H/PC PIM may have no corresponding properties in the desktop PIM. Furthermore, neither PIM is necessarily designed with synchronization in mind.

FIG. 6 shows pertinent architectural components of both H/PC 20 and desktop computer 12 that are used to synchronize objects between desktop object store 18 and the H/PC object store 24. As discussed above, a PIM 22 executes on H/PC 20. A block 80 represents an H/PC synchronization manager, which communicates with a synchronization interface component 25. Synchronization interface component 25 communicates with the H/PC PIM application and/or H/PC object store 24. More specifically, synchronization interface component 25 exposes application programming interfaces 81 that H/PC synchronization manager 80 calls to read and store objects and object properties. Generally, the interfaces allow the creation of databases for different types of objects, and allow application programs to write and read property names and values to and from respective objects within each database. In the exemplary embodiment described herein, the synchronization interface component implements object store manager functionality which is utilized by both H/PC PIM 22 and H/PC synchronization manager 80 to manage objects. The application programming interfaces of synchronization interface component 25 are described in the section entitled "Application Program Interfaces and Methods, Part A" below.

Although there is a great deal of flexibility allowed in storing objects and properties in H/PC object store 24, generally a PIM creates a distinct database for each different object type. For example, different databases are created for appointments and tasks, respectively. A predefined set of properties is supported for each object type. Each database is assigned a name by the application program that creates it. Alternatively, an application program might use a single database for all object types, with the first property for each object defining the type of the object. Objects are uniquely identified within H/PC 20 by object identifiers that are independent of the names assigned by the application programs creating the objects.

Desktop PIM 16 executes on desktop computer 12 and maintains desktop information store 18. A reference store and synchronization manager 82 (referred to below simply as a synchronization manager) also executes on desktop computer 12. This component is responsible for orchestrating synchronization between objects in the H/PC object store and the desktop object store. Synchronization manager 82 maintains a reference store 84, apart from desktop object store 18.

Synchronization manager 82 is not closely associated with desktop PIM 16. Rather, it is an independent component that synchronizes objects from any application program that supports the appropriate desktop synchronization interfaces described below and in the section entitled "Application Program Interfaces and Methods, Part B" below. A number of different application programs can be supported simultaneously by synchronization manager 82.

Communications components 74 and 44 are implemented on H/PC 20 and desktop computer 12, respectively. These components implement serial communications between the computers using a serial cable or an infrared link. H/PC synchronization manager 80 communicates with desktop synchronization manager 82 through these components.

Generally, synchronization manger 82 is configured to compare object instances from the H/PC and desktop object stores in response to connecting the H/PC to the desktop computer for data communications, and to automatically synchronize any objects whose instances differ from each other. In the embodiment described herein, this is performed automatically after the H/PC is initially connected to the desktop computer. Thereafter (as long as the H/PC and desktop computer remain connected), changes to individual object instances in the H/PC or in the desktop computer result in immediate, unsolicited notifications that are sent to synchronization manager 82, indicating which objects have been changed. In response to such notifications, synchronization manager 82 synchronizes the particular object or objects identified by the notifications, rather than repeating a comparison of all object instances. Alternatively, if the particular application program or application programs acting as the object store manager do not have the ability to generate such notifications, the synchronization manager polls at periodic intervals to detect changed object instances. These steps will be explained in more detail below.

Desktop Synchronization Interface Component

Desktop synchronization manager 82 communicates with desktop PIM 16 and accesses desktop object store 18 through a desktop synchronization interface component 90, which corresponds generally to DLL 17 of FIG. 3 and which exposes one or more application program interfaces and methods 91 as described in the section entitled "Application Program Interfaces and Methods, Part B" below. The interfaces most pertinent to the invention are also described in the following general discussion.

The desktop synchronization interface component 90 is implemented specifically to work in conjunction with a particular desktop PIM. In general, providing synchronization for any particular database application requires only the development of a desktop synchronization interface component for the application. Because the application program interface 91 of synchronization component 90 is standardized, it allows synchronization manager 82 to access and synchronize any number of different desktop PIMs, as long as the required interface methods are implemented for each PIM.

In some cases, synchronization interface component 90 and its application program interface 91 might be implemented as part of the desktop PIM. In many other cases, however, they will be designed as "add-ons" or supplemental DLLs, in order to allow synchronization with an application program where synchronization is not provided as an integral feature.

Generally, the desktop synchronization interfaces allow the desktop synchronization manager to compare corresponding objects in the desktop and H/PC object stores, to receive objects from the desktop object store, and to update objects in the desktop object store. By providing these relatively simple functions, the desktop PIM is relieved of the burden of performing actual synchronization.

Identifying Data Segments

The most basic function of reference store 84 is to provide a mapping between instances of objects stored in H/PC object store 24 and desktop object store 18, although it can also provide other functionality as will be described. Objects in H/PC object store 24 are identified by object identifiers. However, these same object identifiers are not used by desktop PIM 16 to identify corresponding object instances in desktop object store 18. In most cases, in fact, PIM 16 is completely unaware that H/PC object store 24 even exists. Accordingly, some type of mapping is required between instances of the same object in the two different object stores.

To identify particular objects in the desktop object store, the invention utilizes data items referred to herein as "identifying data segments." An identifying data segment, generally, is some piece of data that can be used to identify a particular object. The exact composition of an identifying data segment is known only to the synchronization interface components, although identifying data segments are handled and stored by desktop synchronization manager 82. Thus, the developer of a desktop synchronization interface component is allowed to define the format of the identifying data segment. In most cases, an object identifier will be based at least in part on properties of the corresponding object.

Synchronization manager 82 maintains reference store 84 so that it contains identifying data segments corresponding respectively to a plurality of objects in desktop object store 18 that are to be synchronized with instances of the same objects in H/PC object store 24. In most cases, the identifying data segments in the reference store correspond to objects that have previously been synchronized between the two object stores. The identifying data segments are updated after their corresponding objects have been synchronized.

To reiterate, identifying data segments are defined, in the described embodiment, solely by the synchronization interface components. Conceptually, an identifying data segment can be any collection of data that uniquely identifies a particular object in desktop object store 18. The synchronization manager does not directly examine or change the identifying data segments.

In actual implementation, the identifying data segments should be formatted in accordance with the following criteria so that the desktop synchronization interface component can perform its specified functions:

(a) Each identifying data segment should contain data that uniquely identifies an object--such as an object identifier, ID number, a fall path name for a file system object, etc. This data should be persistent (not change for a particular object) and should not be reused for subsequently created objects. This data can be compared to determine whether two identifying data segments actually correspond to the same object.

(b) It should be possible to derive some object order based on the identifying data segment. This is required for efficient searching, as will be explained below.

(c) The identifying data should have some sort of time stamp information. Timestamp information can be compared to determine whether an object has changed since the last identifying data segment was recorded in reference store 84.

The identifying data segments are created by the desktop synchronization interface component and are provided to synchronization manager 82 by a desktop synchronization interface method named "ObjectToBytes". In addition to maintaining a plurality of identifying data segments, synchronization manager 82 also maintains a list of object identifiers corresponding to objects maintained in H/PC object store 24. These identifiers are provided to desktop synchronization manager 82 from H/PC synchronization manager 80 whenever a new object is added to H/PC object store 24. Desktop synchronization manager 82 also maintains a mapping or other indication of correspondence between the object identifiers and the identifying data segments (or the desktop objects to which the identifying data segments correspond).

Obtaining Handles To Objects

Most of the desktop synchronization interfaces are designed so that synchronization manager 82 can reference particular objects by using "handles." The term "handle" as used herein refers to a number or other identifier that can be used to uniquely identify an object and to access the object. Generally, a handle is valid only for a particular time period or session, such as during the time when an object has been "opened." If the same object is opened again, its handle may be different.

Note that the handles used by desktop synchronization interface component 90 do not necessarily correspond to any sort of identifiers used by desktop PIM in desktop object store 18. However, synchronization manager 82 needs to obtain a list of handles corresponding to the objects stored in desktop object store 18 before it can perform any significant synchronization tasks. These handles are provided by the exposed methods of desktop synchronization interface component 90. After obtaining handles, synchronization manager 82 determines a correspondence between the provided handles and object identifiers used by H/PC PIM 22, with reference to reference store 84. FIG. 7 shows the steps performed by synchronization manager 82 to accomplish these tasks.

After an initialization step 100, synchronization manager 82 constructs two lists of handles. The first list is obtained in a step 102 by submitting identifying data segments (previously stored in reference store 84) to a desktop synchronization interface named "BytesToObject." This interface stores a submitted data segment and returns a handle corresponding to the data. Synchronization manager 82 receives the handle and adds it to its first list. Synchronization manager 82 repeats this procedure for each identifying data segment in reference store 84, receiving a handle to each such data segment. The handles correspond respectively to objects belonging to a first group of objects that have been synchronized in the past.

The second list of handles is obtained in a step 104 by querying desktop synchronization interfaces named "FindFirstItem" and "FindNextItem." When successively called, these interfaces enumerate an ordered list of handles corresponding respectively to a second group of objects--those objects currently in desktop object store 18. This group of objects potentially includes at least some of the first group of objects. In fact, this second group of objects will include all objects of the first group except for those objects that have been deleted from the desktop object store since the last synchronization. The enumerated order of the handles is determined by the data in the identifying data segment.

Once the desktop synchronization manager has two lists of handles, it proceeds to perform a step 106 of matching any handles of the first and second lists that correspond to the same object. It does this by repeatedly querying desktop synchronization interface "CompareItem" with pairs of handles from the first and second lists. The interface receives the two handles and returns and indication of whether the two handles correspond to the same object. In addition, for handles that do not correspond to the same object, the interface returns an indication of whether the handle from the first list falls before or after the handle from the second list, relative to the order in which handles were previously enumerated by the FindFIrstItem and FindNextItem interfaces. This allows synchronization manager 82 to implement a more efficient search algorithm as it attempt to find matching handles in the second list for all handles in the first list. However, the synchronization manager is not required to have any understanding of the contents of the identifying data segments--it just submits them to the desktop synchronization interface component for comparison.

CompareItem depends on the inclusion in the identifying data segments of some type of persistent identifier that uniquely identifies an object, and further data that can be used to derive a consistent object order based on the identifying data segments. To determine whether two identifying data segments correspond to the same object, the interface compares the unique identifying data from each data segment. If this test fails, the interface examines a portion of the data segment that is used to derive an object order. This portion of the data segment might comprise a time stamp or some other sequence indication.

Based in the comparison results, desktop synchronization manager 82 performs a step 108 of constructing and maintaining a mapping between handles and object identifiers that are used in H/PC object store. These mappings are derived from mappings maintained between H/PC object identifiers and the identifying data segments maintained in reference store 84. When the synchronization manager receives an object identifier corresponding to a modified object in H/PC synchronization manager 80, the synchronization manager references the mappings with the received object identifier to identify which handle corresponds to the same object in the desktop object store.

Detecting Changes to the Desktop Object Store

If there is a particular handle in the first list that does not have a matching handle from the second list, the desktop synchronization manager concludes that the object corresponding to the particular handle has been deleted from the desktop object store since the last synchronization. Synchronization in this case requires deleting the object from the H/PC object store. On the other hand, if there is a particular handle in the second list that does not have a matching handle from the first list, the synchronization manager concludes that the object corresponding to the particular handle has been added to the desktop object store since the last synchronization. Synchronization in this case requires adding the object to the H/PC object store.

The steps described above allow desktop synchronization manager 82 to determine whether objects have been added to or deleted from the desktop object store since the last synchronization with H/PC object store 24. In addition, however, synchronization manager 82 performs a step 110 (FIG. 7) of determining whether an object has been modified in the desktop object store. This determination is made by querying synchronization interface "IsItemChanged" with matching handles from the first and second lists. The interface compares the identifying data segment associated with each handle to determine whether the object in the desktop object store has been changed since its identifying data segment was written to the reference store. This is possible because the identifying data segment, as noted above, includes time stamp information or some similar information such as a sequence or revision number. If the timestamp information is not identical, there has been a change to the object.

Note that none of these procedures requires synchronization manager 82 to be aware of the particular nature or format of the identifying data segments or of the objects to which they correspond. Rather, interface component 90 is called upon for all actions that depend upon the actual content of the identifying data segments. It is up to the designer of interfaces 90 to define a format for the identifying data segments that will allow the interfaces to perform their required functions.

Detecting Changes to the H/PC Object Store

H/PC synchronization manager 80 is designed to maintain a status bit for each object in H/PC object store 24, indicating whether that object has been changed since the last synchronization. Whenever H/PC PIM 22 changes an object, this bit is set and the H/PC synchronization manager initiates and sends a notification to desktop synchronization manager 82 over whatever communications means are currently employed between the H/PC and the desktop computer. If there is no current communications capability, a log entry is generated so that notice of the change can be sent the next time communications are established. The status bit is reset when a return notification is received indicating that the object has been synchronized in the desktop object store. This methodology eliminates the need to poll the H/PC for object changes.

Synchronizing Objects

Generally, there are three type of events that raise at least a potential need for synchronization:

(a) When the H/PC is first connected to the desktop computer or first establishes communications with the desktop computer.

(b) When an object is created or modified on the portable information device while communications are established.

(c) When an object is created or modified on the desktop computer while communications are established.

When communications are first established between the H/PC and the desktop computer, there are potentially a number of modified, unsynchronized objects on the two computers. As noted above, H/PC synchronization manager 80 maintains a log of such changes. The log is provided to desktop synchronization manager 82 when communications are initially established. The log indicates object identifiers for the objects that have been modified, added, or deleted in the H/PC object store.

On the desktop computer, synchronization manager 82 is responsible for determining which objects have been changed in desktop object store 18. This is accomplished as described above by obtaining a list of handles representing identifying data segments stored in reference store 84 and another list of handles representing objects and corresponding identifying data segments as currently existing in desktop object store 18. The handles are matched and compared to determine whether objects have been added, deleted, or modified since the last synchronization.

FIG. 8 shows the steps performed by the desktop synchronization manager to synchronize objects. In a step 120, the desktop synchronization manager constructs a list of objects that have been changed in the H/PC object store and another list of objects that have been changed in the desktop object store. A step 122 comprises checking whether a particular object has been changed in the desktop object store, in the H/PC object store, or in both. If a particular object has been changed in the H/PC object store, the synchronization manager performs a step 124 of updating the desktop object store with the changed object from the H/PC object store. If a particular object has been changed in the desktop object store, the synchronization manager performs a step 126 of updating the H/PC object store with the changed object from the desktop object store.

In some cases, an object will have changed in both object stores. If so, the user is prompted in a step 128 to resolve the conflict by deciding which modification should be retained. In the exemplary embodiment of the invention, the H/PC instance of the object is retrieved by desktop synchronization manager 82 from H/PC synchronization manager 80 and used to create a new object in desktop object store 18. A handle to the new object is obtained, and synchronization interface "GetConflictInfo" is queried. This interface accepts handles to two objects and returns a conflict resolution text string that is to be used to prompt a user. The text string indicates information about the two objects, such as pertinent records or timestamp information. The synchronization manager uses this text to prompt a user to decide which of the two objects should be retained. If the H/PC version of the object is selected, it replaces the desktop version. If the desktop version is selected, it is sent to the H/PC synchronization manager to overwrite the existing version of the object in H/PC object store 24. As indicated by decision block 130, these steps are repeated for every object.

In other cases, object modifications will occur while communications are already established. In the exemplary embodiment of the invention, synchronization takes place continuously and transparently whenever communications are established. After the H/PC is connected for data communications with desktop computer 12, H/PC synchronization manager 80 initiates and sends a notification to desktop synchronization manager 82 whenever an instance of a particular object in the first object store changes. The notification includes an indication of the specific object identifier of the object that has been modified (the H/PC does not send its entire log of object changes). Synchronization manager 82 is responsive to any notification such as this to synchronize the instances of the identified object in the two object stores. Unless there is a conflict, this involves updating the object in the desktop object store with the changed instance of the object from the H/PC. If there is a conflict, the conflict is handled by asking the user to choose between two modified versions of a particular object, and the chosen version is written to both object stores.

In the embodiment described herein, synchronization in response to notifications such as this take place only after a predefined delay of two seconds from receiving the most recent notification. Because of this, the H/PC can send notifications relating to a plurality of objects, while actual synchronization is delayed until two seconds after the last of the notification is sent. This reduces communications and processing overhead.

On the desktop side, synchronization is scheduled at periodic intervals such as every five minutes, to simulate continuous synchronization. After each interval, desktop synchronization manager 82 polls synchronization interface component 90 to detect changes in desktop object store 18. Specifically, synchronization manager 82 calls synchronization component 90 to enumerate a current list of handles, representing current objects in object store 18. These are then compared to the handles corresponding to identifying data segments in reference store 84 to determine whether any changes have been made since the last synchronization.

In still other cases, desktop PIM 16, or a component such as MAPI that is used in conjunction with PIM 16, might be capable of providing an immediate notification to synchronization manager 82 when an object instance is modified in desktop object store 18. For instance, the PIM might allow synchronization manager 82 to register a callback function. In this case, synchronization manager 82 is responsive to these notifications to synchronize the identified objects without polling for changes and without enumerating and comparing handles. When such notifications are provided, changes in desktop object store 18 can be synchronized continuously as they occur, rather than at periodic intervals.

FIGS. 9-12 show continuous synchronization steps in accordance with a method for synchronizing objects between first and second object stores.

Step 132 of FIG. 9 comprises executing a first object store manager on a first information device (H/PC 20) to maintain a first object store (H/PC object store 24) on the first information device. In the described embodiment, the first object store manager comprises H/PC synchronization manager 80 in combination with H/PC PIM 22 and H/PC synchronization interface component 25.

Step 134 comprises executing a second object store manager on the second information device (desktop computer 12) to maintain a second object store (desktop object store 18) on the second information device. In the described embodiment, the second object store manager comprises desktop PIM 16 in combination with desktop synchronization interface component 90. Other components might also be used within desktop computer 12 to perform the functions of the second object store manager.

A step 136 comprises executing a synchronization manager (desktop synchronization manager 82) on the second information device.

A step 138 comprises connecting the first and second information devices for data communications. After the initial connection, a step 140 is performed of initially synchronizing all objects represented in the first and second object stores. This initial synchronization is accomplished as described above, by obtaining a log from the H/PC and by the use of handles and interfaces 91 obtained from desktop synchronization interface component 90.

After the initial synchronization of step 140, synchronization takes place continuously on an object-by-object basis as indicated by execution block 142 of FIG. 9, until disconnection of the information devices in block 144.

FIG. 10 shows the steps performed by the first object store manager during the continuous synchronization step 142 of FIG. 9. A step 146 comprises monitoring whether object instances have been changed in the first object store. Whenever an object instance is modified, a step 148 is performed of immediately initiating and sending a notification to synchronization manager 82. This step does not require any specific request or polling by synchronization manager 82.

FIG. 11 shows steps performed by synchronization manager 82 in response to the notifications of FIG. 10. A step 150 comprises receiving one or more notifications from the first object store manager. A step 152 comprises delaying for a predefined interval (2 seconds) from the last notification before performing any automatic synchronization. Once this interval has elapsed, a step 154 is performed of synchronizing any objects identified in the received notifications.

In some cases, the second object store manager will also initiate notifications such as those described with reference to FIG. 10. In other cases, however, synchronization manger 82 performs a step of polling the second object store manager at periodic intervals as shown in FIG. 12 to detect changes to instances of objects in the desktop computer. In FIG. 12, this is represented by a delay step 156 and a polling step 158. These steps are performed repetitively during continuous synchronization.

Referring again to FIG. 9, note that initial synchronization step 140 utilizes "full UI," while continuous synchronization step 142 utilizes "suppressed UI." "UI" refers to "user interface." A full synchronization after initially connecting the two computers can involve various types of user interaction, such as error messages, progress indicators, and conflict resolution dialogs. During continuous synchronization, however, such interaction is limited in order to reduce interference with whatever other task the user happens to be performing. Accordingly, synchronization manager 82 does not display user prompts, dialogs (except for conflict resolution dialogs), or status indicators during the continuous synchronization phase. Synchronization manager 82 does display a small icon in the tray area of the Windows 95 taskbar indicating that an object synchronization is taking place.

Because synchronization involves desktop synchronization interface component 90, means are provided for allowing synchronization interface component 90 to detect when continuous synchronization is taking place. When the synchronization interface component detects continuous synchronization, it preferably limits user dialogs and other user interaction.

Specifically, synchronization interface component 90 implements an interface method called "IreplStore::ReportStatus" (see the section entitled "Application Program Interfaces and Methods, Part B" below). This interface is called by synchronization manager 82 to report synchronization status to synchronization interface component 90. Through this interface method various status bits are provided. In accordance with the invention, an additional status bit not described in the section entitled "Application Program Interfaces and Methods, Part B" below is provided through the "ReportStatus" interface method. This status bit, called BSF₋₋ AUTO₋₋ SYNC, is provided to indicate that continuous synchronization is being performed, and to instruct synchronization interface component 90 to limit user interaction.

Exchanging Objects

Desktop synchronization manager 82 is designed to treat objects as arbitrary data streams. The synchronization manager does not examine objects themselves. Special interfaces are associated with both the H/PC PIM and the desktop PIM for exchanging objects. On the desktop, these interfaces are named "GetPacket" and "SetPacket".

FIG. 13 shows steps performed in exchanging objects. A step 160 comprises invoking an interface method named "Setup," that is used to specify a handle corresponding to an object that is to be obtained from desktop object store 18 by desktop synchronization manager 82. Once the object is specified by its handle, GetPacket is called repeatedly in steps 162 and 164 to retrieve a data stream representing the object. This data stream is formatted in a way that is known only to desktop synchronization interfaces 90 and to the corresponding interfaces exposed by H/PC interface component 25. SetPacket works similarly but inversely to GetPacket.

Similar interfaces are provided to work in conjunction with H/PC PIM 22. To send an object from desktop object store 18 to H/PC object store 24, desktop synchronization manager 82 calls the desktop GetPacket repeatedly to obtain a data stream representing the object. As the data stream is obtained, it is sent over the serial communications medium to H/PC synchronization manager 80. H/PC synchronization manager 80 calls the H/PC SetPacket interface, which receives the data stream and converts it into a format suitable for storage in H/PC object store 24. If the object is a new object, the object identifier assigned by H/PC synchronization manager 80 is returned to synchronization manager 82.

The reverse procedure is followed to send an object from H/PC 20 to desktop computer 12. When an object is modified in H/PC object store 24, desktop synchronization manager 82 requests the modified form of the object through communications component 88. It uses the object identifier for the object in conjunction with the mappings to determine which handle corresponds to the object in the desktop object store. It provides this handle and the modified form of the object to the desktop synchronization interface Setup, which in turn instructs desktop PIM 16 to replace the object corresponding to the identified handle with the modified object (or to add a new object if appropriate).

Updating Identifying Data Segments

Identifying data segments in reference store 84 are updated to reflect the current objects in desktop object store 18, but only after the object has been synchronized with the same object in H/PC object store 24. As shown in FIG. 14, updating is accomplished in a step 170 by providing a handle corresponding to a particular object in desktop object store 18 to a synchronization interface called "Updateitem." In response, the desktop synchronization interface component modifies the stored identifying data segment by updating its time stamp data. At a later time, the desktop synchronization manager performs a step 172 of calling interface ObjectToBytes to update the identifying data segment stored in the reference store.

Mapping Properties and Saving Unsupported Properties

Desktop synchronization interfaces 90 are responsible for mapping properties from H/PC object store 25 to corresponding properties in desktop object store 18. As described above, objects are sent to interface SetPacket as data streams. SetPacket parses the data stream, identifies particular property values, and stores at least some of the properties or property values as corresponding properties in an object of desktop object store 18. The correspondence between H/PC properties and desktop properties is determined by the designer of the desktop synchronization interface component 90. Actual storage of objects and properties in desktop object store 18 is accomplished by calling COM or other interfaces exposed by the particular desktop PIM 16.

In some cases, certain properties provided from H/PC object store 24 have no corresponding properties in desktop object store 18. Such properties are referred to herein as unsupported properties. FIG. 15 shows the steps performed in handling unsupported properties. A step 180 comprises receiving a plurality of properties through the SetPacket interface. In a step 182, data representing any unsupported properties is returned to desktop synchronization manager 82 through the ObjectToBytes interface as part of the identifying data segments, without storing the properties in the desktop object store. The properties are thus stored in reference store 84, in a step 184 performed by the desktop synchronization manager, rather than in desktop object store 18. Alternatively stated, the identifying data segment for a particular object includes data representing any object properties not supported by the desktop object store. Since ObjectToBytes is invoked after updating desktop object store 18 with an object from H/PC object store 24, there is always an opportunity to update the identifying data segments with currently synchronized data.

FIG. 16 shows steps performed in retrieving unsupported properties. Before retrieving a particular object from desktop object store with GetPacket, synchronization manager 82 invokes the BytesToObject interface in a step 186, submitting the object's handle and its identifying data segment (which includes data representing the unsupported properties). Subsequently, in step 188, GetPacket returns the object, including the unsupported properties, and the object is in turn provided to H/PC synchronization manager 80 for storage in H/PC object store 24.

Ancillary Features

The desktop synchronization manager is configured to detect or to be notified when a portable information device has been connected for synchronization. Such notification can be generated automatically, or the user can initiate the notification.

DLLs associated with particular PIM application programs are listed in the Windows registry of the desktop computer. When a portable information device is connected, it notifies the synchronization manager of database or PIM programs that wish to participate in synchronization. The desktop synchronization manager examines the Windows registry and loads any registered DLLs that are required to synchronize database or PIM programs executing on the desktop computer. The synchronization manager also examines the registry to determine what object types are available for each DLL.

In the exemplary embodiment, each object type is represented as a "folder." An initial step performed by synchronization manager 82 is to call appropriate interfaces to obtain handles to such folders. As described in the section entitled "Application Program Interfaces and Methods, Part B" below, folder handles are used for various management purposes.

Application Program Interfaces and Methods, Part A Conclusion

The invention provides an extremely versatile way to synchronize desktop database application programs that might not have been originally designed with synchronization in mind. The invention allows for continuous and automatic synchronization of database objects and other objects such as files without any significant user effort. In most cases, synchronization does not require modification of the database application programs. Rather, synchronization can be provided by implementing DLLs that execute in conjunction with the application programs. The DLL itself is not required to actually perform synchronization tasks, but rather is only required to perform specific data manipulations that are fairly straightforward in implementation.

Although the invention has been described in language specific to structural features and/or methodological steps, it is to be understood that the invention defined in the appended claims is not necessarily limited to the specific features or steps described. Rather, the specific features and steps are disclosed as exemplary forms of implementing the claimed invention.

Application Program Interfaces and Methods, Part B Object Store

About the Object Store

A Handheld PC (HPC) uses RAM to store user data, downloaded applications, and run-time data for applications. Additionally, a portion of RAM is reserved for use by the operating system. The portion that is available to applications is called the object store. This chapter describes the object store and the functions that an application uses to manipulate the object store.

Structure of the Object Store

The Windows CE object store supports three main groups of application programming interfaces (APIs):

The System Registry API

The File System API

The Database System API

The System Registry API

The Windows CE system registry is similar to that used in the Windows NT and Windows 95 operating systems. A Windows CE application uses the standard Win32 registry functions to manipulate keys and values in the registry. For a list of the Win32 registry functions supported by Windows CE, see the "Reference Index" section at the end of this chapter.

The File System API

An application can use the Windows CE file system API to create directories and data files in the object store, read and write file data, and retrieve file and directory information. An application manipulates objects in the file system using the Win32 file system functions. For a list of the Win32 file system functions supported by Windows CE, see the "Reference Index" section at the end of this chapter.

The Database System API

The Windows CE operating system contains functions that an application can use to create and manipulate databases. Windows CE only supports databases that have a single-level hierarchy; nested objects are not supported. The object store can contain many databases, each containing any number of records. Each record can contain one or more properties. A property can be one of the following:

A signed or unsigned integer value

A null-terminated string

A FILETIME structure

An array of bytes (also called a "BLOB")

Windows CE keeps track of the databases and records in the object store using object identifiers. Every database and record is assigned a unique object identifier. Some database functions require an object identifier to specify the target object. An application can define a variable for holding an object identifier by using the PEGOID data type defined in the Windows CE header files.

Creating a Database

Each database in the object store has a name and a type identifier. The name is a null-terminated string consisting of up to 32 characters. The type identifier is a double-word value that can be used for any application-defined purpose. Typically, an application uses the type identifier to differentiate one type of database from another while enumerating the databases in the object store.

In addition to a name and a type identifier, a database can also have up to four sort orders active at one time. A sort order determines the order in which the database seek functions search through the records in a database. An application defines the sort orders by filling an array of SORTORDERSPEC structures. For more information about sort orders, see the "Sorting and Seeking Records" section of this chapter.

An application creates a database by using the PegCreateDatabase function. When calling the function, the application specifies the name and the type identifier for the database, a pointer to an array of SORTORDERSPEC structures, and a value that specifies the number of structures in the array. If no sort orders are needed, the application can specify a NULL pointer and zero structures. If the PegCreateDatabase function succeeds, the object identifier of the newly created database is returned. An application uses the identifier to open a database in order to manipulate its contents. To destroy a database, the application passes the database's object identifier to the PegDeleteDatabase function.

Enumerating Databases

The PegFindFirstDatabase and PegFindNextDatabase functions allow an application to enumerate the databases in the object store. An application begins an enumeration sequence by calling the PegFindFirstDatabase function, specifying the identifier of the type of database to enumerate. If the application specifies a valid type identifier, the enumeration sequence finds only the given type of database. If the application specifies a type identifier of zero, all databases in the object store are enumerated.

The PegFindFirstDatabase function returns a handle to an enumeration context. To find the next database of the given type, the application passes the handle to the PegFindNextDatabase function. This function returns the object identifier of the next database, not a handle. Each subsequent call to PegFindNextDatabase returns the object identifier of the next database in the enumeration sequence. When no more databases of the given type remain in the object store, PegFindNextDatabase returns the ERROR₋₋ NO₋₋ MORE₋₋ ITEMS error value.

When the application is finished enumerating databases, it must close the handle to the enumeration context by using the CloseHandle function.

Records and Properties

A database consists of a set of records, each containing one or more data fields called properties. For example, a Contacts application would contain a database of address records, and the properties of each record might consist of a name, street address, city, state, zip code, and telephone number. The maximum size of a record is 128K. The maximum property size is 64K.

Each property in a record has an identifier that the system uses to sort database records and to locate properties to be read or modified. A property identifier is a two part, double word value of the type PEGPROPID. The high order word is an application-defined identifier, and the low order word is a predefined constant value that specifies the property's data type. The constants are defined in the Windows CE header files; they begin with the PEGVT₋₋ prefix. An application can use the TypeFromPropID macro to extract the type from a property identifier.

Opening a Database

Before an application can read, write, or delete records or properties in a database, a handle to the database must be obtained using the PegOpenDatabase function. When calling PegOpenDatabase, an application must specify either the name of the database to open, or the object identifier of the database (returned by a previous call to the PegCreateDatabase or PegFindNextDatabase function). The PegOpenDatabase function returns an open database handle that the application can use in other functions to read or make changes to the contents of the database. When the application finishes using the database, close the handle by calling the CloseHandle function.

If the application specifies the PEGDB₋₋ AUTOINCREMENT flag when calling PegOpenDatabase, the system automatically increments the seek pointer with each call to the PegReadRecordProps function. The seek pointer marks the record that will be read by the next read operation. For more information about moving the seek pointer, see the "Sorting and Seeking Records" section of this chapter.

When calling PegOpenDatabase, an application can specify the identifier of a property to use as the sort order for the open database handle. The system uses the sort order to determine where to move the seek pointer after each subsequent call to PegReadRecordProps (if the PEGDB₋₋ AUTOINCREMENT flag is specified). The sort order also determines the property that the PegSeekDatabase function uses to traverse the database. For more information about sort orders, see the "Sorting and Seeking Records" section of this chapter.

It is possible for multiple applications to have open handles to the same database at the same time. Any application that has an open handle can make changes to the database. The system can post notification messages to your application whenever another application makes a change to a database that your application has open. For example, the system will post DB₋₋ PEGOID₋₋ CREATED when another application adds a new record, or DB₋₋ PEGOID₋₋ RECORD₋₋ DELETED when a record is deleted. To get these notifications, the application must specify the handle of the window that is to receive the notifications in the call to PegOpenDatabase.

Reading and Writing Records and Properties

An application creates new records or modifies existing records using the PegWriteRecordProps function. The function parameters include the handle to the database and the object identifier of the record to add. If the object identifier is zero, PegWriteRecordProps creates a new record.

To write properties to a record, the application fills an array of PEGPROPVAL structures and passes the address of the array to PegWriteRecordProps along with the database handle and the record's object identifier. Each structure contains a property identifier and the data value for that property. To specify the data value, an application fills the val member, which is defined as a PEGVALUNION union. The PEGPROPVAL structure also includes a flag member that an application can set to PEGDB₋₋ PROPDELETE in order to delete the given property or properties. If the PegWriteRecordProps function succeeds, the object identifier of the new or modified record is returned.

The PegReadRecordProps function reads properties from the record where the seek pointer is currently positioned. When calling PegReadRecordProps, an application indicates the properties to be read by specifying an array of property identifiers. The application also specifies the buffer into which the function is to write the property information, and a value indicating the size of the buffer. If the application specifies the PEGDB₋₋ ALLOWREALLOC flag, the system will reallocate the buffer if it is too small to hold the property information. Note that the system stores records in compressed format, and must decompress records as they are read. For efficiency, an application should read all of the desired properties in a single call rather than several separate calls.

If the PegReadRecordProps function succeeds, a copy of the property information is copied into the specified buffer as an array of PEGPROPVAL structures. The return value is the object identifier of the record. If the system cannot find a requested property in the given record, the PEGPROPVAL structure for that property receives the PEGDB₋₋ PROPNOTFOUND flag. All of the variable size data such as strings and BLOBs are copied to the end of the buffer. The PEGPROPVAL structures contain pointers to this data. Before returning, PegReadRecordProps increments the seek pointer by one if the application specified the PEGDB₋₋ AUTOINCREMENT flag when it called PegOpenDatabase to open the database.

An application uses the PegDeleteRecord function to delete a record from a database, specifying the object identifier of the record, and an open handle to the database that contains the record.

Sorting and Seeking Records

Each of the records in a database typically contain a similar set of properties, and each type of property typically shares the same property identifier. For example, each record in a Contacts database might contain a name, street address, city, state, zip code, and telephone number. Each name property would have the same property identifier, each street address property would have the same property identifier, and so on. An application can select one of these properties and direct the system to sort the records based on the selected property. For example, the application can direct the system to sort the Contacts records by name, city, or state. The order in which the records are sorted affects the order in which the database seeking function PegSeekDatabase finds records in the database.

When creating a new database, an application can specify up to four different sort order descriptions to associate with the database. A sort order description is a SORTORDERSPEC structure that contains the identifier of a property on which the database records are to be sorted. The structure also includes a combination of flags that indicate whether to sort the records in ascending or descending order, whether the sort is case sensitive, and whether to place records that do not contain the given property before or after all other records.

An application specifies which sort order to use when it calls the PegOpenDatabase function to open a handle to the database. Only one sort order can be active for each open handle. However, by opening multiple handles to the same database, an application can use more than one sort order.

An application uses the PegSeekDatabase function to search for a record in a database. The function can perform several different types of seek operations. When calling the function, an application specifies a flag that indicates the type of seek operation to perform, and a value whose meaning depends on the specified flag. For example, to find a particular record, an application specifies the PEGDB₋₋ SEEK₋₋ PEGOID flag and the object identifier of the desired record. When PegSeekDatabase finds a record, the seek pointer is positioned at that record. Any subsequent read operation takes place at the location of the seek pointer.

Seek operations are affected by the sort order associated with the open database handle. For example, suppose the Contacts database is currently sorted based on the name property. If the application specifies the PEGDB₋₋ SEEK₋₋ VALUEFIRSTEQUAL flag and a value of "Joe Smith," the PegSeekDatabase function will search from the beginning of the database looking only at the name property of each record, and stopping when (and if) a matching property is found.

The sort orders for a database are set when the database is created. An application can change the sort order after creating a database by using the PegSetDatabaseInfo function, but this can be an extremely expensive operation in terms of system resources. It is expensive because the system maintains a set of indices and other information that it uses to optimize database searches for the given sort orders. When new sort orders are specified, the system must revise all of that internal information. Revising the information can take several minutes for large databases.

Database Information

The PegSetDatabaseInfo function allows an application to set various parameters of a database, including name, type, and sort order descriptions. An application fills a PEGDBASEINFO structure with the new database information and then passes the address of the structure and the object identifier of the database to the PegSetDatabaseInfo function.

An application can retrieve information about an object in the object store by using the PegOidGetInfo function. An application specifies the identifier of an object and the address of a PEGOIDINFO structure, which the function fills with the object information. The specific content of the structure depends on the type of the object for which information is being retrieved. For example, if the object is a database record, the structure receives the OBJTYPE₋₋ RECORD flag and a PEGRECORDINFO structure containing the object identifier of the database in which the record resides.

Using the Object Store

This section contains sample code that demonstrates how to use the Windows CE database functions to perform the following tasks:

Create and open a database

Write records and properties to a database

Seek a record in a database

Read the contents of a database record. ##SPC1## 

What is claimed is:
 1. A continuously synchronized storage system, comprising:first and second information devices that are connectable for data communications, at least one of the information devices comprising a portable information device; first and second object stores maintained on the first and second information devices, wherein the first and second object stores contain synchronized instances of objects; a synchronization manager that executes on one of the first and second information devices, the synchronization manager being configured to receive a notification when an instance of a particular object in the first object store changes; the synchronization manager being responsive to the notification to synchronize the instances of the particular object in the first and second object stores; wherein the synchronization manager does not poll for the notification; wherein the synchronization manager polls at periodic intervals to detect changed object instances in the second object store; and wherein the synchronization manager is responsive to changed object instances in the second object store to synchronize such changed instances with object instances in the first object store.
 2. A continuously synchronized storage system as recited in claim 1, wherein the synchronization manager is configured to synchronize object instances in response to notifications only after a predefined delay from the most recent notification.
 3. A continuously synchronized storage system as recited in claim 1, wherein the synchronization manager limits user interaction when synchronizing in response to notifications.
 4. A continuously synchronized storage system, comprising:first and second information devices that are connectable for data communications, at least one of the information devices comprising a portable information device; first and second object stores maintained on the first and second information devices, wherein the first and second object stores contain synchronized instances of objects; a synchronization manager; a first object store manager that maintains the first object store and that initiates a notification to the synchronization manager when an instance of a particular object in the first object store changes; wherein the synchronization manager is responsive to the notification to synchronize the instances of said particular object in the first and second object stores.
 5. A continuously synchronized storage system as recited in claim 4, wherein the notification is a first notification, further comprising:a second object store manager that maintains the second object store and that initiates a second notification to the synchronization manager when an instance of the particular object in the second object store changes; wherein the synchronization manager is responsive to the second notification to synchronize the instances of said particular object in the first and second object stores.
 6. A continuously synchronized storage system as recited in claim 4, wherein:the synchronization manager polls at periodic intervals to detect changed object instances in the second object store; and the synchronization manager is responsive to changed object instances in the second object store to synchronize such changed instances with object instances in the first object store.
 7. A continuously synchronized storage system as recited in claim 4, wherein the synchronization manager is configured to synchronize object instances in response to notifications only after a predefined delay from the most recent notification.
 8. A continuously synchronized storage system as recited in claim 4, wherein the synchronization manager limits user interaction when synchronizing in response to notifications.
 9. A method of synchronizing objects between first and second object stores, comprising the following steps:executing an object store manager to maintain the first object store on a portable information device; initiating a notification from the object store manager whenever an instance of a particular object in the first object store changes; and executing a synchronization manager that responds to the notification by synchronizing instances of the particular object in the first and second object stores.
 10. Computer-readable storage media having instructions for performing the steps recited in claim
 9. 11. A method as recited in claim 9, wherein the synchronization manager synchronizes object instances in response to notifications only after a predefined delay after receiving the most recent notification.
 12. A method as recited in claim 9, comprising a further step performed by the synchronization manager of polling at periodic intervals to detect changes to instances of objects in the second object store.
 13. A method as recited in claim 9, wherein the object store manager executes on the portable information device.
 14. A method as recited in claim 9, wherein the object store manager executes on the portable information device and the synchronization manager executes on a different device.
 15. A method as recited in claim 9, further comprising a step of maintaining the second object store on an information processing device other than the portable information device, wherein:the object store manager executes on the portable information device; and the synchronization manager executes on the information processing device other than the portable information device.
 16. A method as recited in claim 9, comprising a further step of limiting user interaction while synchronizing objects in response to notifications.
 17. A system for synchronizing object instances between first and second object stores, comprising:a primary computer; a portable computer that is connectable with the primary computer for data communications; a first object store manager that executes on the portable computer to maintain the first object store; a second object store manager that executes on the primary computer to maintain the second object store; a synchronization manager that executes on the primary computer; wherein the synchronization manager compares object instances from the first and second object stores in response to connecting the portable computer for data communications with the primary computer, and synchronizes any objects whose instances differ from each other; the first object store manager being configured to initiate a notification to the synchronization manager after the portable computer is connected for data communications with the primary computer whenever an instance of a particular object in the first object store changes; wherein the synchronization manager is responsive to the notification to synchronize the instances of said particular object in the first and second object stores.
 18. A system as recited in claim 17, wherein the synchronization manager limits user interaction when synchronizing in response to notifications.
 19. A system as recited in claim 17, wherein the second object store manager potentially interacts with a user during synchronization, and wherein the synchronization manager instructs the second object store manager to limit user interaction when synchronizing in response to notifications.
 20. A system as recited in claim 17, wherein the second object store manager potentially interacts with a user during synchronization, and wherein:the second object store manager exposes an interface method that accepts an instruction to limit user interaction; the synchronization manager invokes the interface method and instructs the second object store manager to limit user interaction when synchronizing in response to notifications.
 21. A system as recited in claim 17, wherein the notification is a first notification, and wherein:the second object store manager is configured to initiate a second notification to the synchronization manager after the portable computer is connected for data communications with the primary computer whenever an instance of a particular object in the second object store changes; and the synchronization manager is further responsive to a second notification to synchronize the instances of the particular object in the first and second object stores.
 22. A system as recited in claim 17, wherein the synchronization manager polls at periodic intervals to detect changed object instances in the second object store.
 23. A system as recited in claim 17, wherein the synchronization manager is configured to synchronize object instances in response to notifications only after a predefined delay from the most recent notification. 